home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_2 / getscreenid / gsi.doc < prev    next >
Text File  |  1994-10-04  |  6KB  |  180 lines
  1.           #############################################################
  2.  
  3.                                  GetScreenID 1.1
  4.  
  5.                          Written by GONCALVES A. Georges
  6.  
  7.                Copyright © 1994 by GONCALVES A. Georges ( Melkor )
  8.                                All rights reserved
  9.  
  10.           #############################################################
  11.  
  12.  
  13.  
  14.                                    User manual
  15.  
  16.                                        of
  17.  
  18.                                    GetScreenID
  19.                                    version 1.1
  20.  
  21.  
  22.                                    * Sommary *
  23.  
  24.  
  25.                         1 - Disclaimer
  26.                         2 - Distribution
  27.                         3 - Introduction
  28.                         4 - Requirements
  29.                         5 - Usage
  30.                         6 - Hints and Tips
  31.                         7 - Acknowledgements
  32.                         8 - Contacting author
  33.  
  34.  
  35.   1 - Disclaimer :
  36.   ----------------
  37.  
  38.   The author is not responsible for any damage caused directly  or  indirectly
  39.   by  the  use  of this program. If your monitor explode, your hardisk crashed
  40.   and no more formatable or your 680x0 changed in an Intel type processor  its
  41.   not my fault. Use it at your own risk.
  42.  
  43.  
  44.   2 - Distribution :
  45.   ------------------
  46.  
  47.   You can distribute it as long as you don't make money with it :(  It's NOT
  48.   public domain but freely distribuable. Really, it's a CardWare program. That
  49.   means if you enjoy and use it, you have the moral obligation to send me a
  50.   postal card of your city or country, not so expensive I think ;-)
  51.  
  52.  
  53.   3 - Introduction :
  54.   ------------------
  55.  
  56.   Have you never been annoyed when you want to display a  picture,  with  your
  57.   favourite  viewer,  in  a different screenmode than the one specified in the
  58.   picture file and your viewer asks for a display ID or the string name of the
  59.   screenmode instead of opening a ScreenModeRequester like the Asl or Reqtools
  60.   ones ? Sure yes ! Don't you think that is very boring to type something like
  61.   "PAL:High  Res  no  flicker"  every  time  you  want  it.  This  string only
  62.   represents the DisplayID  of  a  ScreenMode  and  its  better  to  choose  a
  63.   ScreenMode in a requester, isn't it ? That's the job of GetScreenID. It
  64.   works similary to those GetPubName programs.
  65.  
  66.  
  67.   4 - Requirements :
  68.   ------------------
  69.  
  70.   You must have some little things in order to get GSI to work :
  71.  
  72.     - Reqtools.library V38 or better
  73.     
  74.     - a little Shell knowledge ( very little )
  75.     
  76.     - an Amiga ( GSI is useless on PCs as Screens don't exists ;-> )
  77.  
  78.     - You must hate MicroSoft Windows ;-)
  79.  
  80.  
  81.   5 - Usage :
  82.   -----------
  83.  
  84.   Here is the HARDER part ( joke ! )
  85.  
  86.   From Workbench : Doubleclick it and you'll have a ScreenModeRequester.
  87.                    Choose the Mode and a Requester will show you the
  88.                    appropriate DisplayID. Workbench use is most for info
  89.                    purpose.
  90.  
  91.   From Shell     : Type GSI and you'll get the ScreenModeRequester. When
  92.                    selected the DisplayID is inserted in the command line
  93.                    so you can use it as follows :
  94.  
  95.                    PicViewer Pics:BeautyfullGirl SCREENMODE=`GSI`
  96.  
  97.                    and your PicViewer will receive as argument :
  98.  
  99.                    PicViewer Pics:BeautyfullGirl SCREENMODE=A9004
  100.  
  101.                    for "PAL:High Res No Flicker".
  102.  
  103.  
  104.   Can it be easier ?
  105.  
  106.  
  107.   6 - Hints ans tips :
  108.   --------------------
  109.  
  110.   GSI has some features that can be transparent for a normal user and usefull
  111.   for experienced ones.
  112.  
  113.   o The requesters appear on the frontmost public screen.
  114.  
  115.   o if the program that requires the DisplayID wants a 'C' formated hex number
  116.     just add the 'C' prefix for a hex number : 0x or 0X
  117.  
  118.     ex:  PicViewer Pics:BeautyfullGirl SCREENMODE=0x`GSI` or ...MODE=0X`GSI`
  119.  
  120.     to   PicViewer Pics:BeautifullGirl SCREENMODE=0xA9004 or ...MODE=0XA9004
  121.  
  122.  
  123.   7 - Acknowledgements :
  124.   ----------------------
  125.  
  126.   GSI has been created using SAS/C 6.51 ( Poor guys on PCs with Borland  C  :-)
  127.   It  was linked with the TinyStartup lib © Stéphane BUNEL ( TinyStartup is the
  128.   MUI of startups, it controls all for you and so simple to use ( even  a  BABY
  129.   can  program  with  it  ! ). Edition by GoldED ( Only Dietmar Eilert makes it
  130.   possible ) on OS 3.x Kickstart 40.68, Workbench 40.42 ( What a wonderfull  OS
  131.   ! ). Documentation was a piece of cake with the ( buggy but cool ) AGWritter.
  132.   Of course, only an Amiga can run this thingies ( Thanks to the engineers  for
  133.   making a so wonderfull computer ).
  134.  
  135.   and now the friends...
  136.  
  137.  
  138.   Stéphane Bunel : Katov
  139.                    TinyStartup is now really good and reliable. no more 'c.o'.
  140.                    'Amiga for ever and PC for Lamer...'
  141.  
  142.   Christophe Paoutoff : Showgger
  143.                         Hello 'Chojé', GSC is the best CPU board ever made.
  144.                         4 CPUs, 3 CoPros and NO hardware needed :-)
  145.                         That's the Exec's fault !!!!
  146.  
  147.   Olivier Laudren : Cople
  148.                     RayTracing master !!! How are you my friend ?
  149.  
  150.   Nicolas Frank : Gryzor
  151.                   ProWizard et DeliWizard are the ProTracker rulers !!!
  152.  
  153.   Kersten Emmrich : Emmy
  154.                     33MHz ist nein genug, 40MHz ist gut !!!
  155.   
  156.   Magnus Holmgren :
  157.                     Hello to my friend, the swedish knight :)
  158.  
  159.   Federico Giannici :
  160.                       impossible to live without CycleToMenu !!!
  161.  
  162.   and many others I forgot, sorry :(
  163.  
  164.  
  165.   8 - Contacting the author :
  166.   ---------------------------
  167.  
  168.   I can be reached at :
  169.  
  170.     Goncalves A. Georges
  171.     27, rue Morand
  172.     75011 Paris
  173.     FRANCE
  174.  
  175.   Sorry, no E-Mail address ( not yet :) .
  176.  
  177.  
  178.  
  179.  
  180.